using System.ComponentModel.DataAnnotations;

namespace ClassDemo.Model.DTO;

/// <summary>
/// 学生登录数据传输对象
/// </summary>
/// <remarks>
/// 用于学生登录接口的请求参数，支持学号或手机号作为账号登录
/// </remarks>
/// <example>
/// 使用学号登录：
/// {
///   "account": "2024001",
///   "password": "123456"
/// }
/// 
/// 使用手机号登录：
/// {
///   "account": "13800138001",
///   "password": "123456"
/// }
/// </example>
public class StudentLoginDto
{
    /// <summary>
    /// 登录账号，可以是学号或手机号
    /// </summary>
    /// <value>
    /// 支持两种格式：
    /// 1. 学号：通常为数字组合，如 2024001
    /// 2. 手机号：11位数字，如 13800138001
    /// </value>
    [Required(ErrorMessage = "学号或手机号不能为空")]
    public string Account { get; set; } = string.Empty;

    /// <summary>
    /// 登录密码
    /// </summary>
    /// <value>
    /// 学生账号对应的登录密码
    /// </value>
    [Required(ErrorMessage = "密码不能为空")]
    public string Password { get; set; } = string.Empty;
}